Developer Documentation

QuickTime 4 API Documentation

QuickTime 4 Reference

Previous | Chapter Top | Chapter Contents | Next |

Controller Numbers

The controller numbers used by QuickTime are mostly identical to the standard MIDI controller numbers. These are signed 8.8 values. The full range, therefore, is -128.00 to 127+127/128 (or 0x8000 to 7FFF) .

All controls default to zero except for volume and pan.

Pitch bend is specified in fractional semitones, which eliminates the restrictions of a pitch bend range. You can bend as far as you want, any time you want.

The last 16 controllers (113-128) are global controllers. Global controllers respond when the part number is given as 0, indicating the entire synthesizer.

enum {
    kControllerModulationWheel          = 1,
    kControllerBreath                   = 2,
    kControllerFoot                     = 4,
    kControllerPortamentoTime           = 5,
    kControllerVolume                   = 7,
    kControllerBalance                  = 8,
    kControllerPan                      = 10,
    kControllerExpression               = 11,
    kControllerLever1                   = 16,
    kControllerLever2                   = 17,
    kControllerLever3                   = 18,
    kControllerLever4                   = 19,
    kControllerLever5                   = 80,
    kControllerLever6                   = 81,
    kControllerLever7                   = 82,
    kControllerLever8                   = 83,
    kControllerPitchBend                = 32,
    kControllerAfterTouch               = 33,
    kControllerSustain                  = 64,
    kControllerSostenuto                = 66,
    kControllerSoftPedal                = 67,
    kControllerReverb                   = 91,
    kControllerTremolo                  = 92,
    kControllerChorus                   = 93,
    kControllerCeleste                  = 94,
    kControllerPhaser                   = 95,
    kControllerEditPart                 = 113,
    kControllerMasterTune               = 114
};

Constant descriptions

kControllerModulationWheel
This controller controls the modulation wheel. A modulation wheel adds a periodic change to the volume or pitch of a sounding tone, depending on the modulation depth knobs.
kControllerBreath
This controller controls breath.
kControllerFoot
This controller controls the foot pedal.
kControllerPortamentoTime
This controller adjusts the slur between notes. Set the time to 0 to turn off portamento; there is no separate control to turn portamento on and off.
kControllerVolume
This controller controls volume.
kControllerBalance
This controller controls balance between channels.
kControllerPan
This controller controls balance on the QuickTime music synthesizer and some others. Values are 256- 512, corresponding to left to right.
kControllerExpression
This controller provides a second volume control.
kControllerLever1 through kControllerLever8
These are all general purpose controllers.
kControllerPitchBend
This controller bends the pitch. Pitch bend is specified in positive and negative semitones, with 7 bits per fraction.
kControllerAfterTouch
This controller controls channel pressure.
kControllerSustain
This controller controls the sustain effect. The value is a Boolean--positive for on, 0 or negative for off.
kControllerSostenuto
This controller controls sostenuto.
kControllerSoftPedal
This controller controls the soft pedal.
kControllerReverb
This controller controls reverb.
kControllerTremolo
This controller controls tremolo.
kControllerChorus
This controller controls the amount of signal to feed to the chorus special effect unit.
kControllerCeleste
This controller controls the amount of signal to feed to the celeste special effect unit.
kControllerPhaser
This controller controls the amount of signal to feed to the phaser special effect unit.
kControllerEditPart
This controller sets the part number for which editing is occurring. For synthesizers that can edit only one part.
kControllerMasterTune
This controller offsets the entire synthesizer in pitch.
© 1999 Apple Computer, Inc.

Previous | Chapter Top | Chapter Contents | Next